home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glgetmaterial.z / glgetmaterial
Encoding:
Text File  |  2002-10-03  |  8.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallllffffvvvv,,,, ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvv - return material parameters
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallllffffvvvv( GLenum _f_a_c_e,
  14.                            GLenum _p_n_a_m_e,
  15.                            GLfloat *_p_a_r_a_m_s )
  16.      void ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvv( GLenum _f_a_c_e,
  17.                            GLenum _p_n_a_m_e,
  18.                            GLint *_p_a_r_a_m_s )
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _f_a_c_e    Specifies which of the two materials is being queried.  GGGGLLLL____FFFFRRRROOOONNNNTTTT
  23.              or GGGGLLLL____BBBBAAAACCCCKKKK are accepted, representing the front and back
  24.              materials, respectively.
  25.  
  26.      _p_n_a_m_e   Specifies the material parameter to return.  GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT,
  27.              GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE, GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR, GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN, GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS, and
  28.              GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS are accepted.
  29.  
  30.      _p_a_r_a_m_s  Returns the requested data.
  31.  
  32. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.      ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll returns in _p_a_r_a_m_s the value or values of parameter _p_n_a_m_e of
  34.      material _f_a_c_e. Six parameters are defined:
  35.  
  36.      GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT            _p_a_r_a_m_s returns four integer or floating-point
  37.                            values representing the ambient reflectance of the
  38.                            material.  Integer values, when requested, are
  39.                            linearly mapped from the internal floating-point
  40.                            representation such that 1.0 maps to the most
  41.                            positive representable integer value, and -1.0 maps
  42.                            to the most negative representable integer value.
  43.                            If the internal value is outside the range [-1, 1],
  44.                            the corresponding integer return value is
  45.                            undefined. The initial value is (0.2, 0.2, 0.2,
  46.                            1.0)
  47.  
  48.      GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE            _p_a_r_a_m_s returns four integer or floating-point
  49.                            values representing the diffuse reflectance of the
  50.                            material.  Integer values, when requested, are
  51.                            linearly mapped from the internal floating-point
  52.                            representation such that 1.0 maps to the most
  53.                            positive representable integer value, and -1.0 maps
  54.                            to the most negative representable integer value.
  55.                            If the internal value is outside the range [-1, 1],
  56.                            the corresponding integer return value is
  57.                            undefined. The initial value is (0.8, 0.8, 0.8,
  58.                            1.0).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR           _p_a_r_a_m_s returns four integer or floating-point
  75.                            values representing the specular reflectance of the
  76.                            material.  Integer values, when requested, are
  77.                            linearly mapped from the internal floating-point
  78.                            representation such that 1.0 maps to the most
  79.                            positive representable integer value, and -1.0 maps
  80.                            to the most negative representable integer value.
  81.                            If the internal value is outside the range [-1, 1],
  82.                            the corresponding integer return value is
  83.                            undefined. The initial value is (0, 0, 0, 1).
  84.  
  85.      GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN           _p_a_r_a_m_s returns four integer or floating-point
  86.                            values representing the emitted light intensity of
  87.                            the material.  Integer values, when requested, are
  88.                            linearly mapped from the internal floating-point
  89.                            representation such that 1.0 maps to the most
  90.                            positive representable integer value, and -1.0 maps
  91.                            to the most negative representable integer value.
  92.                            If the internal value is outside the range [-1,
  93.                            1.0], the corresponding integer return value is
  94.                            undefined. The initial value is (0, 0, 0, 1).
  95.  
  96.      GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS          _p_a_r_a_m_s returns one integer or floating-point value
  97.                            representing the specular exponent of the material.
  98.                            Integer values, when requested, are computed by
  99.                            rounding the internal floating-point value to the
  100.                            nearest integer value. The initial value is 0.
  101.  
  102.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS      _p_a_r_a_m_s returns three integer or floating-point
  103.                            values representing the ambient, diffuse, and
  104.                            specular indices of the material.  These indices
  105.                            are used only for color index lighting.  (All the
  106.                            other parameters are used only for RGBA lighting.)
  107.                            Integer values, when requested, are computed by
  108.                            rounding the internal floating-point values to the
  109.                            nearest integer values.
  110.  
  111. NNNNOOOOTTTTEEEESSSS
  112.      If an error is generated, no change is made to the contents of _p_a_r_a_m_s.
  113.  
  114. EEEERRRRRRRROOOORRRRSSSS
  115.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_a_c_e or _p_n_a_m_e is not an accepted value.
  116.  
  117.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllGGGGeeeettttMMMMaaaatttteeeerrrriiiiaaaallll is executed between
  118.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  119.  
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      ggggllllMMMMaaaatttteeeerrrriiiiaaaallll
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.